home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3dm / audio / ALgetconfig.z / ALgetconfig
Encoding:
Text File  |  1998-10-20  |  6.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. AAAALLLLggggeeeettttccccoooonnnnffffiiiigggg((((3333ddddmmmm))))                                              AAAALLLLggggeeeettttccccoooonnnnffffiiiigggg((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ALgetconfig, ALsetconfig - (obsolete) get/set the AAAALLLLccccoooonnnnffffiiiigggg structure of
  10.      an audio AAAALLLLppppoooorrrrtttt structure
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////aaaauuuuddddiiiioooo....hhhh>>>>
  14.  
  15.      AAAALLLLccccoooonnnnffffiiiigggg AAAALLLLggggeeeettttccccoooonnnnffffiiiigggg((((AAAALLLLppppoooorrrrtttt ppppoooorrrrtttt))))
  16.      iiiinnnntttt AAAALLLLsssseeeettttccccoooonnnnffffiiiigggg((((AAAALLLLppppoooorrrrtttt ppppoooorrrrtttt,,,, AAAALLLLccccoooonnnnffffiiiigggg ccccoooonnnnffffiiiigggg))))
  17.  
  18. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRR
  19.      _p_o_r_t     expects an AAAALLLLppppoooorrrrtttt structure, the returned value of an
  20.               AAAALLLLooooppppeeeennnnppppoooorrrrtttt((((3333ddddmmmm)))) call.
  21.  
  22.      _c_o_n_f_i_g   expects an AAAALLLLccccoooonnnnffffiiiigggg structure, the returned value of a call to
  23.               AAAALLLLnnnneeeewwwwccccoooonnnnffffiiiigggg((((3333ddddmmmm)))) or AAAALLLLggggeeeettttccccoooonnnnffffiiiigggg((((3333ddddmmmm)))).
  24.  
  25. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  26.      AAAALLLLsssseeeettttccccoooonnnnffffiiiigggg and AAAALLLLggggeeeettttccccoooonnnnffffiiiigggg are obsolete and are provided for backward
  27.      compatibility. The preferred functions are aaaallllSSSSeeeettttCCCCoooonnnnffffiiiigggg((((3333ddddmmmm)))) and
  28.      aaaallllGGGGeeeettttCCCCoooonnnnffffiiiigggg((((3333ddddmmmm)))).
  29.  
  30.      AAAALLLLggggeeeettttccccoooonnnnffffiiiigggg((((3333ddddmmmm)))) leaves _p_o_r_t unchanged, but returns an AAAALLLLccccoooonnnnffffiiiigggg structure
  31.      initialized to the configuration values of the audio port.
  32.      AAAALLLLffffrrrreeeeeeeeccccoooonnnnffffiiiigggg((((3333ddddmmmm)))) should be called when the returned AAAALLLLccccoooonnnnffffiiiigggg is no
  33.      longer needed.
  34.  
  35.      AAAALLLLggggeeeettttccccoooonnnnffffiiiigggg((((3333ddddmmmm)))) can fail for the following reasons:
  36.  
  37.      AAAALLLL____BBBBAAAADDDD____PPPPOOOORRRRTTTT         _p_o_r_t is either invalid or null.
  38.  
  39.      AAAALLLL____BBBBAAAADDDD____OOOOUUUUTTTT____OOOOFFFF____MMMMEEEEMMMM   insufficient memory is available to allocate the
  40.                          AAAALLLLccccoooonnnnffffiiiigggg structure.
  41.  
  42.      AAAALLLLsssseeeettttccccoooonnnnffffiiiigggg((((3333ddddmmmm)))) changes the configuration of the audio port, _p_o_r_t, to
  43.      match that described by the AAAALLLLccccoooonnnnffffiiiigggg structure, _c_o_n_f_i_g.
  44.  
  45.      AAAALLLLccccoooonnnnffffiiiigggg structures contain information which specifies configuration
  46.      options for a port such as queuesize, sample width, and channel setting.
  47.  
  48.      AAAALLLLsssseeeettttccccoooonnnnffffiiiigggg((((3333ddddmmmm)))) can fail for the following reasons:
  49.  
  50.      AAAALLLL____BBBBAAAADDDD____PPPPOOOORRRRTTTT       _p_o_r_t is either invalid or null.
  51.  
  52.      AAAALLLL____BBBBAAAADDDD____CCCCOOOONNNNFFFFIIIIGGGG     _c_o_n_f_i_g is either invalid or null.
  53.  
  54.      AAAALLLL____BBBBAAAADDDD____DDDDEEEEVVVVIIIICCCCEEEE     _p_o_r_t and _c_o_n_f_i_g have conflicting device settings.
  55.  
  56.      AAAALLLL____BBBBAAAADDDD____QQQQSSSSIIIIZZZZEEEE      _p_o_r_t and _c_o_n_f_i_g have conflicting values for queue size.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. AAAALLLLggggeeeettttccccoooonnnnffffiiiigggg((((3333ddddmmmm))))                                              AAAALLLLggggeeeettttccccoooonnnnffffiiiigggg((((3333ddddmmmm))))
  71.  
  72.  
  73.  
  74.      AAAALLLL____BBBBAAAADDDD____CCCCHHHHAAAANNNNNNNNEEEELLLLSSSS   _p_o_r_t and _c_o_n_f_i_g have conflicting channels settings.
  75.  
  76. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  77.      When AAAALLLLggggeeeettttccccoooonnnnffffiiiigggg((((3333ddddmmmm)))) fails, it returns a null-valued AAAALLLLccccoooonnnnffffiiiigggg.
  78.  
  79.      Upon successful completion, AAAALLLLsssseeeettttccccoooonnnnffffiiiigggg((((3333ddddmmmm)))) returns 0. Otherwise,
  80.      AAAALLLLsssseeeettttccccoooonnnnffffiiiigggg((((3333ddddmmmm)))) returns -1 and sets an error number which can be
  81.      retrieved using oooosssseeeerrrrrrrroooorrrr((((3333CCCC)))).
  82.  
  83. NNNNOOOOTTTTEEEE
  84.      The device, queue size, and the number of channels of a port are static
  85.      attributes; they cannot be changed once a port is opened.
  86.       If you attempt to change any of these values, AAAALLLLsssseeeettttccccoooonnnnffffiiiigggg((((3333ddddmmmm)))) will
  87.      fail.
  88.  
  89. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  90.      ALfreeconfig(3dm), ALnewconfig(3dm), ALsetqueuesize(3dm),
  91.      ALsetwidth(3dm), ALsetchannels(3dm), oserror(3C)
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.